home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / qrbull30.zip / QRBULL.DOC < prev    next >
Text File  |  1992-08-15  |  10KB  |  235 lines
  1.  
  2.  
  3.                              QRBull  Vers 3.00                Aug 15 1992
  4.  
  5.                 (c) Copyright 1992 by John Jamieson
  6.                          All Rights Reserved
  7.  
  8.  
  9. *** Intro:
  10.  
  11.   QRBull is a simple MultiNode compatable Bulletin system for QuickBBS
  12.   Remote Access or other BBS's that create DorInfo1.Def. QRBull will
  13.   incorporate any text file with the extension .BUL, that is located in
  14.   your QRBull subdirectory. The menu will be sorted in order of the File
  15.   Date and the first line of the file will be used as the description in
  16.   the QRBull menu. QRBull has a bit more capability, but not much as I
  17.   wanted to keep it simple. I am open to suggestions.
  18.  
  19.  
  20. Example QRBull main Menu and Status Bar:
  21.  
  22.    ╔════════════════════════════════════════════════════════════════════════╗
  23.    ║           ░░▒▒▓▓██  Mountain Retreat Bulletin Menu  ██▓▓▒▒░░           ║
  24.    ╠════════════════════════════════════════════════════════════════════════╣
  25.    ║  A    Electronic and Communications Privacy Act Info    06/08/1992     ║
  26.    ║  B    *NEW*  QRDB Data Base Door                        06/06/1992     ║
  27.    ║  C    New User Introduction                             06/06/1992     ║
  28.    ║  D    Sending NetMail to a UseNet/InterNet Address      06/06/1992     ║
  29.    ║  E    Offline reader support                            06/02/1992     ║
  30.    ║  F    Levels And Limits                                 05/20/1992     ║
  31.    ║  G    A few Tips on the use of this system              01/19/1992     ║
  32.    ║  H    UpLoad Policy                                     01/05/1992     ║
  33.    ║                                                                        ║
  34.    ║  X    Exit QRDB                                                        ║
  35.    ╠════════════════════════════════════════════════════════════════════════╣
  36.    ║   QRBull Door - by John Jamieson - Mountain Retreat BBS (408)335-4595  ║
  37.    ╚════════════════════════════════════════════════════════════════════════╝
  38.  Selection:
  39.  ┌───────────────────────────────────────────────────────────────────────────┐
  40.  │John Jamieson                 Level=100     Baud=2400        Graphics=On   │
  41.  │Felton, Ca                    Min's Left=67                  Alt-H= Hangup │
  42.  └───────────────────────────────────────────────────────────────────────────┘
  43.  
  44.  
  45.  
  46. *** Quick Start:
  47.  
  48.   A couple of sample Bulletins are included in the package. Just place
  49.   the QRBull package of files in their own directory and run QRBull or
  50.   QRBull /M for Local in monochrome.
  51.  
  52.   Edit QRBull.TTL and change the title to fit your system.
  53.  
  54.   To Run QRDB as a door add the environment variable
  55.   SET QRBBULL=C:\QRBULL, set it to whatever directory QRBull is located
  56.   in. Then create a type 7 menu type and in the Optional data field just
  57.   place the command C:\QRBULL\QRBULL.EXE *M  that's all their is to it.
  58.   QRBull, when running as a door, needs access to DorInfo1.Def. QRDB
  59.   must be run from the directory containing those BBS files.
  60.  
  61.   QRBull defaults to Local mode, without a status line, if it can't find
  62.   DorInfo1.Def. It will also run in local Local mode if the baud rate it
  63.   finds in DorInfo1.Def is 0. In the case of Local mode with DorInfo1.Def,
  64.   QRBull will include status bar.
  65.  
  66.   My setup is as follows. I run QRBull as a regular user selectable menu
  67.   item on my Main.Mnu and also as a Top.Mnu (Ctrl-A) automatically
  68.   Executed Menu Item that executes just prior to automatically executing
  69.   my Main.Mnu. My Top.Mnu has three items on it, all three are
  70.   automatically executed using a (Ctrl-A) Key code. First item is Sysop
  71.   menu, a type 1 item that is only executed if the person loging on has
  72.   sysop level access.  Second is QRBull, a type 7 menu item. Third and
  73.   last is the BBS Main menu, a type 1 menu item. The last two menu items
  74.   are not executed if caller has sysop access. If the caller has sysop
  75.   level access he/she is passed to the Sysop menu. All others are
  76.   presented with the QRBull menu and after exiting QRBull they are
  77.   presented with the BBS Main Menu.
  78.  
  79.  
  80. *** Files:
  81.  
  82. QRBull.EXE        The QRBull BBS Door
  83. QRBull.TTL        A text file that stores the title that you give
  84.                    to the QRBull Main Menu
  85. QRBull.DOC        This File
  86. QRBull.KEY        Key to QRDB operation
  87. PRIVACY.BUL       Sample bulletins
  88. USENET.BUL        Sample bulletins
  89.  
  90.  
  91. *** Here is all you need to know when creating a bulletin:
  92.  
  93.     To add a Bulletin you will just create the bulletin, a text file
  94.     with the extension .BUL and place it in your QRBull subdirectory.
  95.     The first line of your bulletin in addition to being used in the
  96.     QRBull menu will be used as the title. That is really all you have
  97.     to do, but you can add a bit of color or have QRBull position your
  98.     data, see info on instruction lines below.
  99.  
  100.     The Title is the first line of text is read by QRBull. There should
  101.     be no blank lines before the title.
  102.  
  103.     Line Length should be limited to 80 characters and the title should
  104.     be no more than 47 characters. Long lines are truncated.
  105.  
  106.     A DOS pipe character in position one of a line identifies that line
  107.     as an instruction line. Color, Indentation, and Line Centering
  108.     instructions can be given QRBull on an instruction line.
  109.     The second character in the instruction line must be a color code.
  110.  
  111.        The colors available are as follows:
  112.          R: Red
  113.          Y: Yellow
  114.          G: Green
  115.          B: Blue
  116.          C: Cyan
  117.          M: Magenta
  118.          W: White
  119.     The third and forth characters in the instruction line tell QRBull
  120.     how to position the data when it is displayed. A number is read as
  121.     spaces to indent the data, If the third character is a C, the data
  122.     will be centered on the line. If the third and forth characters are
  123.     blank then the data is positioned exactly as it is read.
  124.  
  125.                            ******************
  126.  
  127. The following is an example bulletin file.
  128.  
  129. ────────────────────────────────────────────────────Example .BUL───┐
  130. Electronic and Communications Privacy Act Info                     │
  131.                                                                    │
  132. |CC                                                                │
  133. The following info is made available as per federal requirements,  │
  134. pursuant to the Electronic and Communications Privacy Act of 1986, │
  135. Title 18, of the United States Code, Section 2510.                 │
  136.                                                                    │
  137. |RC                                                                │
  138. NOTICE IS HEREBY GIVEN THAT THERE ARE NO FACILITIES PROVIDED BY    │
  139. THIS BULLETIN BOARD SYSTEM FOR SENDING OR RECEIVING PRIVATE or     │
  140. CONFIDENTIAL ELECTRONIC COMMUNICATIONS or E-MAIL! ALL MESSAGES     │
  141. CAN and MAY BE READ BY THE SYSTEMS OPERATOR!                       │
  142.                                                                    │
  143.  
  144.                            ******************
  145.  
  146. This is how the above file will look when displayed as a bulletin
  147.  
  148.   ╔════════════════════════════════════════════════════════════════════════╗
  149.   ║  ░▒         Electronic and Communications Privacy Act Info         ▒░  ║
  150.   ╚════════════════════════════════════════════════════════════════════════╝
  151.  
  152.  
  153.       The following info is made available as per federal requirements,
  154.       pursuant to the Electronic and Communications Privacy Act of 1986,
  155.              Title 18, of the United States Code, Section 2510.
  156.  
  157.        NOTICE IS HEREBY GIVEN THAT THERE ARE NO FACILITIES PROVIDED BY
  158.        THIS BULLETIN BOARD SYSTEM FOR SENDING OR RECEIVING PRIVATE or
  159.        CONFIDENTIAL ELECTRONIC COMMUNICATIONS or E-MAIL! ALL MESSAGES
  160.                CAN and MAY BE READ BY THE SYSTEMS OPERATOR!
  161.  
  162.  Press Enter to Continue :
  163.  
  164.  
  165.  
  166. *** Trouble shooting the QRBull door installation:
  167.  
  168.   The Status bar can be an aid in trouble shooting the door installation.
  169.   a.  No status bar indicates that the BBS config file was not found and
  170.       QRBull is running in local mode.
  171.   b.  A status bar with a Baud rate other than 0 indicates the DorInfo1.Def
  172.       file has been read, QRBull has Config and user info and is running as
  173.       a door.
  174.   c.  If the status bar shows a baud rate of 0 and user name in the status
  175.       bar is Sysop then the BBS config file has been read, no DorInfo1.Def
  176.       has been found and QRBull is running in local mode.
  177.   d.  If the status bar shows a baud rate of 0 and user name in the status
  178.       bar is NOT Sysop then the BBS config file has been read, DorInfo1.Def
  179.       has Read and QRBull is running in local mode.
  180.  
  181.  
  182. *** History
  183.  
  184.     Version 1.00    Initial Release
  185.     Version 2.00b   Beta Release switched to use of DorInfo1.Def
  186.                     in order to make the door useable on more
  187.                     systems.
  188.     Version 3.00    Release of DorInfo1.Def version
  189.  
  190. *** Disclaimer agreement:
  191.  
  192.     Users of QRBull must except the following disclaimer agreement:
  193.  
  194.     QRBull is are provided AS IS. The Author makes no Warranty of any
  195.     kind, expressed or implied. In addition THE AUTHOR ASSUMES NO
  196.     LIABILITY FOR DAMAGES WHICH MAY RESULT WHICH MAY RESULT FROM THE USE
  197.     OF QRBull.
  198.  
  199.  
  200.  
  201.  
  202. *** Registration
  203.  
  204.     QRBull is ShareWare, a $5 registration fee is required. For an
  205.     additional $10, a total of $15 I'll send you a copy of the latest
  206.     version with with a 65 character message of your choice replacing
  207.     the following line in the QRBull menu.
  208.  
  209.   ╠════════════════════════════════════════════════════════════════════════╣
  210.   ║  QRBull  Door - by John Jamieson - Mountain Retreat BBS (408)335-4595  ║
  211.   ╚════════════════════════════════════════════════════════════════════════╝
  212.  
  213.     If you decide to continue useing QRBull after a 90 day trial period
  214.     you are expected to register. Please send your registration fee to:
  215.  
  216.              John Jamieson
  217.              Mountain Retreat BBS
  218.              555 Buckeye St.
  219.              Felton Ca, 95018
  220.  
  221.     Include the Name of your BBS as it appears in your BBS Config if you
  222.     are adding your message to the Menu.
  223.  
  224.     For support contact:
  225.  
  226.              Fidonet 1:216/506
  227.              InterNet johnj@clovis.ca.us
  228.              BBS phone (408)335-4595
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.